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Preface 


This manual describes the functions and use of the Network Logical Data 
Manager (NLDM) program product. It explains the relationship of NILDM to 
other network components and provides an example of how NLDM is used in 
network problem determination. It contains planning information, including 
hardware, software, and storage requirements. It also contains a list of related 
publications and a program summary. 


This manual is intended primarily for installation managers and planners and for 
anyone who requires an overview of NLDM. 


This manual consists of the following chapters: 


e Chapter 1 contains a general overview of NLDM and describes the 
relationship of NLDM to other network components. 


e Chapter 2 describes NLDM functions and the data collected by NLDM. 


e Chapter 3 describes how NLDM is used and contains a scenario showing how 
NLDM may be used in problem determination. 


e Chapter 4 describes hardware, software, and storage requirements for NLDM, 
| includes performance considerations, and lists related publications. 


e Chapter 5 contains a program summary of NLDM. 


A glossary containing definitions of NLDM terms and abbreviations precedes the 
Index to this manual. 


Systems Network Architecture (SNA) terms are used in this manual. Readers 


unfamiliar with SNA should refer to Systems Network Architecture Concepts and 
Products, GC30-3072. 
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Chapter 1. Introduction 


The Network Logical Data Manager (NLDM) program product collects and 
correlates data related to SNA sessions between network addressable units 
(NAUs) and provides users with online access to the collected data. It allows a 
user at a central control point to identify network problems and helps to identify 
undetected errors such as unresponsive terminals, lost path information units 
(PIUs), buffer errors, and resource status errors. 


NLDM collects data relating to SNA sessions in both single-domain and 
multiple-domain networks and maintains the collected session data on a session 
basis. In addition, NLDM collects data relating to the data flows for certain 
non-SNA terminals not supported by the Network Terminal Option (NTO). 


NLDM collects session data from the SNA access method (ACF/VTAM or 
ACF/TCAM) and from the network control program (ACF/NCP). The session 
data includes information about session activation and deactivation, the session 
partners, the physical configuration associated with the session, access method 
PIU data, and network control program (NCP) data. 


NLDM runs as an application program under Network Communications Control 
Facility (NCCF) and can coexist with the Network Problem Determination 
Application (NPDA) program product and with the IBM 3600 Threshold Analysis 
and Remote Access Feature. Any user logged onto NCCF can access NLDM. 


NLDM uses system functions provided by NCCF to communicate with the SNA 
access method and with the VSAM data base in which the collected session data 
is stored. Refer to the NCCF General Information manual for more information 
about NCCF functions. 


The environment under which NLDM operates is shown in Figure 1 on page 2. 


Chapter 1. Introduction 1 


User 
Application NLDM 
Program — 


a A 


User 


Application 
Program 


SNA Access Method 
Frti“‘t‘s‘sts ae 
Processor 
User 
ACF/NCP Terminals 


User 
Terminals ACF/NCP 


a 


Host 
Processor* 


or User 
Terminals 


*The NLDM program product must be initialized in the host processor. 


Figure 1. NLDM Environment 
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Chapter 2. Functions and Data 


Functions 


Initialization 


Collecting Session Data 


This chapter describes the functions performed by NLDM, the two kinds of 
session data collected and displayed by NLDM, and the data base used for storing 
the session data. 


After it is initialized, NLDM collects session data, activates and deactivates 
session traces, and displays session data. 


NLDM is initialized whenever NCCE is initialized. Initialization consists of 
building internal control blocks, opening the NLDM VSAM data base, 
establishing communications with the access method, starting collection of session 
awareness data, and using the start-up parameters specified by the customer in an 
NCCE parameter definition data set, such as starting session trace or specifying 
the amount of data to be kept for each session trace started. 


The data collected by NLDM comes from SNA sessions involving logical units 
(LUs), physical units (PUs), or system services control points (SSCPs), and from 
data flows to or from non-SNA terminals not supported by NTO, which NLDM 
treats as LUs. (Non-SNA terminals supported by NTO appear to the host to be 
SNA resources; NLDM collects session data from SNA sessions involving those 
terminals. ) 


NLDM can collect two types of data about a session. One type of session data 
collected is session awareness data. Session awareness data includes the session 
type, the names of the session partners, and information about the session 
activation status. Session awareness data is collected for all sessions. 


The second type of session data collected by NLDM is known as session trace 
data. Session trace data consists of session activation parameters, access method 
path information unit (PIU) data, and NCP data. Session trace data is collected 
only for sessions involving a resource for which a session trace has been started. 


Collected session data is stored in buffers. Whenever a session ends, the 
associated session data is transferred from the buffers to the VSAM data base. A 
user may also request that data pertaining to an active session be transferred to 
the data base. 


Figure 2 on page 4 shows the types of resources for which NLDM can collect 
session data. 
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Figure 2. Resources That Can Have Sessions Traced 


Activating and Deactivating Session Traces 
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NLDM begins collecting session trace data only after a session trace is started. A 
trace may be started during or after NLDM initialization. 


Session traces are started at NLDM initialization for resources specified in the 
NCCE parameter definition data set; resources that can be specified in that data 
set are all LUs, all SSCPs, or all LUs and SSCPs. 


After NLDM is initialized, the user may start session traces for all network 
resources or for specific network resources. In a multiple-domain network, a user 
in one domain may start a session trace for a resource in another domain if 
NLDM has been initialized in that domain. Session trace data is collected for a 
session involving two resources in the same domain when a session trace is started 
for either session partner. In a multiple-domain network, all session trace data for 
a cross-domain session is collected only when session traces are started in both 
domains. 


After NLDM is initialized, the user may stop session traces for all network 
resources or for specific network resources. 


Displaying Session Data 


NLDM allows the user to display the collected session data using a series of 
panels. If the user wants to display information about an active session, NLDM 
retrieves the session data from main storage. If the user wants to display 
information about a previously active session, NLDM gets the session data from 
the VSAM data base. 


Session awareness data is displayed in the following ways: 


e NAU lists 
« A list of the most recent sessions for an NAU 
e Session configuration 


Session trace data is displayed in the following ways: 
e Session activation parameters 


e Access method PIU data 
e NCP data 
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NLDM can collect and display two types of session data: session awareness data 
and session trace data. The following topics describe the data collected and 
displayed by NLDM. 


Session awareness data is collected by NLDM whenever a session begins or ends. 
It includes information from the access method about the session activation status, 
the session type, and the session partners for LU-LU, SSCP-LU, SSCP-PU, or 
SSCP-SSCP sessions. It includes information about the activation status for 
non-SNA terminals not supported by NTO. 


Session awareness data is displayed in the form of NAU lists, lists of most recent 
sessions for specific NAUs, and session configuration diagrams. 


The user may display lists of all network addressable units (NAUs) known to 
NLDM. Lists can be displayed showing the NAU names of all secondary logical 
units (SLUs), all primary logical units (PLUs), all LUs, all PUs, or all SSCPs. An 
NAU list indicates which NAUs are involved in active sessions. 


The user can display a list of the most recent sessions in which a specific NAU 
was a partner. The list is in reverse chronological order and if a session is 
currently active, it is the first entry in the list. The information displayed includes 
the name, type, and domain of each session partner. The session activation and 
deactivation times are shown for sessions that have ended; the session activation 
time is shown for an active session. 


The user may display the physical configuration of the part of the network in 
which the primary or secondary end of a specific session is located. The 
configuration includes the network names of the resources shown. Also displayed 
are the names and addresses of the session partners and the name of the domain 
from which the data is being viewed. 


Session trace data is collected by NLDM whenever a session trace is started. 
Session trace data consists of session activation parameters, access method PIU 
data, and NCP data. 


The user can display the parameters used for session activation if a trace is started 
for a session before the session is activated and if the session is successfully 
activated. Session activation parameters are those parameters included in the 
SNA command used to activate the session (Bind Session, Activate Physical Unit, 
Activate Logical Unit, or Activate CDRM). The session activation paren 
can be displayed in either hexadecimal or text representation. 


Access Method PIU Data 


NCP Data 


VSAM Data Base 


The user may display access method PIU data for all sessions for which NLDM 
collects session data. PIU data includes the transmission header (TH), the 
request/response header (RH), and the first 11 bytes of the request unit (RU). 
PIU data may be displayed in either hexadecimal or text representation. 


The user may display NCP data for sessions involving NCP-attached resources. 
Except for SSCP-LU sessions, NCP data consists of the last 4 PIU sequence 
numbers and selected fields from control blocks that relate to the specific resource 
involved in the session. For SSCP-LU sessions, NCP data consists of control 
block information only. 


NLDM stores collected session data in a VSAM data base. The user specifies the 
name and size of the data base during the installation of NLDM. Session data 
associated with an active session is kept in main storage. When the session ends, 
the session data is copied from main storage into the VSAM data base. The user 
may also request that the data be transferred from main storage to the data base 
while the session is still active. | 
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Chapter 3. Usage and Operation 


This chapter shows ways NLDM may be used and briefly describes the operation 
of NLDM. It also summarizes the commands and the panels, shows examples of 
session tracing, and includes a problem-determination scenario. | 


Usage 


NLDM may be used in several ways, depending on the needs of a particular 
system or installation. 


NLDM can be used to help identify the first occurrence of a problem. To be sure 
that NLDM is collecting session data when a problem first occurs, you must 
initialize NLDM before activating the network and you must begin trace of all 
sessions at initialization. 


To use NLDM to help identify a subsequent occurrence of a problem, you may 
(1) initialize NLDM before activating the network and then begin traces of 
sessions involving specific or all resources, or (2) activate the network before 
initializing NLDM and then begin traces of sessions involving specific or all 
resources. 


Note: If NLDM is initialized after the network is activated, session trace data can 
be collected only for sessions that are activated (or reactivated) after NLDM 
initialization; for such sessions, NCP data is not collected. If NLDM is initialized 
after the network is activated and all sessions are to be traced, the NCP or NCPs 
must be restarted. 
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This topic briefly describes the operation of NLDM after it has been initialized. 
Operating NLDM consists of starting and stopping session traces and displaying 
session data. | 


Session traces may be started for some sessions as part of NLDM initialization. 
After NLDM is initialized, any user logged onto NCCF may start a session trace 


for any resource shown in Figure 2 on page 4. To collect session trace data for a 


session involving session partners in the same domain, the user starts a session 
trace for either session partner. To collect all session trace data for a session 
involving session partners in different domains, the user starts session traces in 


both domains. 


A user may start a session trace either before or after the network is activated, 
depending on the intended use of NLDM. See “Usage” on page 9 for more 
information about using NLDM. 


After NLDM is initialized, any user logged onto NCCF may use NLDM 
commands to stop session traces of sessions involving specific or all resources. 


After NLDM is initialized, any user logged onto NCCF may display the collected 
session data using the NLDM panels. The panel sequence begins with lists of 
session partner names listed by session type and progresses to a list of the most 
recent sessions for a specific NAU. The user may then display configuration 
information or session trace data for a specific session and can choose to display 
some information in hexadecimal representation. 


Whenever desired, the user can end the NLDM panel sequence and return to 
NCCE. 


NLDM Commands 


The following list describes the NLDM commands. Some NLDM commands are 
assigned to program function (PF) keys. 


Command 


BACK 


BOTTOM 


COPY 


DISKEEP 


END 


FORCE 


FORWARD 


HELP 


KEEP 


LIST 


MENU 


RETURN 


SDOMAIN 


SESS 


SET HEX 


TITLE 


TRACE 


Description 
Displays the previous page of a multiple-page panel. 
Displays the last page of a multiple-page panel. 


Prints at a hard-copy device a copy of the current panel or a 
copy of the current page for a multiple-page panel 


Displays settings for the amount of session trace data to be 
kept. 


Stops the NLDM panel sequence and returns the user to 
NCCE. 


Causes session data to be recorded in the data base. 
Displays the next page of a multiple-page panel. 
Explains the NLDM commands. 

Changes the amount of session trace data to be kept. 
Displays a list of NAU names known to NLDM. 
Displays the NLDM menu. 


Displays the panel that was displayed prior the the current 
panel. 


Determines the NCCF domain for which session data is to 
be displayed. 


Displays the session list for a specific NAU. 


Causes certain panels to be displayed in hexadecimal 
representation. 


Displays the first page of a multiple-page panel. 
Starts or stops a session trace. Displays a list of resource 
names for which session traces have been started; if session 


tracing was started for all resources, displays a list of 
resource names for which session traces have been stopped. 
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NLDM Panels 
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The following chart shows the relationships between the panels and how a user 
moves from one panel to another. Some panels may be accessed directly by using 


the NLDM command shown. 
MENU 
DISKEEP Display 
| Keep 
Settings 
LIST acai HELP 
= TRACE Display 
Trace 


SESS 


_ Figure 3. 
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NLDM Panels 


Examples of Session Tracing 


NLDM collects session data for sessions in both single-domain networks and 
multiple-domain networks. The following examples show what types of session 
trace data are available depending on the sessions established and the resources 
for which session traces have been started. 


Tracing in a Single-Domain Network 


The following diagram shows a sample single-domain network. 


APPL1 (LU) 


CLUSTERB (PU) 
TERM2 (LU) 


SSCP 


APPL2 (LU) 


CLUSTERA (PU) 
TERM1 (LU) 


The following table indicates what session trace data is available depending on the 
sessions established and the resources for which session traces have been started. 
Not all sessions and resources for which session traces may be started are shown. 


LU-LU SSCP-LU | SSCP-PU | 
APPL1- | APPL1- | APPL1- |sscp- | sscp- |sscp- | sscp- | sscp- SSCP- SSCP- 
APPL2 | TERM1 | TERM2 | APPL1 | APPL2 | TERM1 | TERM2 |CLUSTERA|CLUSTERB | NCP 
APPL pete tote ft 
apPL2. | P| ee eee ee eee ee 


Resource 
for 
Which 
Session 
Trace 
Is 
Started 


Cacia OE TES ESE ES EE Se 
CLuerenE ee 


a Peter ere yt ter et ae 


' ACF/VTAM only 
2NCP control block information only 


Legend 


P = PIU data and session activation parameters 
N = NCP data 


Figure 4. Session Tracing in a Single-Domain Network 
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Tracing in a Multiple-Domain Network 


The following diagram shows a sample multiple-domain network. 
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The following table indicates what session trace data is available depending on the 
sessions established, the resources for which session traces have been started, and 
the host at which the session trace was started. Not all sessions and resources for 
which session traces may be started are shown. 


Sessions 
LU-LU SSCP-LU | SSCP-SSCP_ | SSCP-SSCP_ 


APPL1- | APPL1- | APPL1- |SSCP1-| SSCP2-| SSCP2-| SSCP2-] SSCP1- 
APPL2 | TERM1 | TERM2 JAPPL1 | APPL2 | TERM1 | TERM2] SSCP2 


Resource 
for 
Which 
Session 
Trace Is 
started 
at Host 1 


1 ACF/VTAM only 
2NCP control block information only 


Legend 
P = PIU data and session activation parameters 
N = NCP data 


Figure 5. Session Tracing in a Multiple-Domain Network 
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Scenario 
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This topic provides an overview of the scenario described in the NLDM 
Installation and Operation manual. The scenario shows how NLDM can be used 
to determine the source of a problem. 


In this scenario, the symptom of the problem is an unresponsive user terminal, 
that is, the terminal user cannot send messages to or receive messages from the 
host. The user terminal is an NCP-attached BSC 3270 terminal. The conditions 
for this scenario are as follows: — 


e The access method, NCCF, and NLDM have been initialized. 

« The network is active. _ 

¢ Session traces were started for the user terminal, which is identified as 
T620101, and the host application identified as SNAMH101. 

¢ T620101 has started a session with SNAMH101. 

¢ 1620101 has quit responding and the terminal user has reported the problem 
to the network operator. 


Two persons are involved in the scenario, a network operator and a diagnostician. 
The operator makes sure that all parts of the network are operating. The 
diagnostician has an understanding of Systems Network Architecture and 
diagnoses problems when some part of the network is not operating. In some 
installations, the operator and the diagnostician may be the same person. 


The panels referred to in the scenario are shown on a foldout page at the back of 
the manual. The steps in the scenario are as follows: . 


1. The network operator starts the NLDM panel sequence and issues the 
command SESS T620101 to display the session history panel (Figure 7). 
There, the operator finds information about the most recent session associated 
with the unresponsive terminal (T620101). 


2. The operator issues SC to display the session configuration for the 
unresponsive terminal (Figure 8). The operator uses the configuration 
information to identify the logical names of hardware components that may 
be causing the unresponsive terminal condition. The operator checks for 
hardware errors, and if no hardware errors are detected for the identified 
hardware components, the operator continues using NLDM for problem 
determination. 


3. The operator issues PT to display the PIU data for the primary LU 
(SNAMH101) and ST to display the NCP data for the secondary LU 
(T620101) that was collected just before the terminal quit responding 
(Figures 9 and 10). Displaying the data causes the most recent data to be 
retrieved from the access method and the NCP and brought into main storage 
so that the operator can then store the data in the NLDM VSAM data base. | 


4. The operator issues the FORCE command, which causes the session data to be 
copied from main storage into the data base, and then the operator reports the 
problem to the diagnostician. 


5. The diagnostician continues problem determination using the PIU data panel 
(Figure 9), which displays the data stored in the data base by the operator. 
The diagnostician determines that the last session data collected for the 
session was a PIU sent by the primary LU (SNAMH101) to the secondary LU 
(T620101) requesting a definite response. 


6. The diagnostician then uses information on the NCP data panel (Figure 10), 
also stored by the operator in the data base, to determine that the last 
sequence number was transmitted by the host and that the last sequence 
number received from the NCP was for the Signal Command. The 
diagnostician also determines from the NCP data that the NCP was waiting 
for a data response and that there are no outstanding pacing requests. 


7. The diagnostician concludes that the secondary LU (T620101) did not 
transmit a response to the PIU and that the unexpected SIGNAL command 
sent to the host caused the host to lose synchronization with the terminal. As 
a result, the diagnostician calls for service on the terminal. 
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Chapter 4. Planning for NLUDM 


This chapter discusses how to plan for the installation of NLDM and describes the 
hardware, software, and storage requirements. It also includes performance 
considerations, describes an initialization requirement, and lists related 
publications. 


Hardware Requirements 


A System/370, 30xx, or 4300 processor or the equivalent supported by 
ACF/TCAM or ACF/VTAM running with OS/VS2 MVS Release 3.8, or later, 
is required for NLDM. 


An NLDM user may access the NLDM program product through any terminal 
supported by NCCF. If an IBM 3279 Display Station Model 2A or 3A is used, 
the NLDM panels are displayed in base colors. If an IBM 3279 Display Station 
Model 2B or 3B is used, the NLDM panels are displayed in 7 colors. 


Software Requirements 


Network Communications Control Facility (NCCF) Release 2 with the 
appropriate PTF running on OS/VS2 MVS Release 3.8, or later, is a prerequisite 
for NLDM. Refer to the NCCF General Information manual for additional 
dependencies and prerequisites. NLDM runs as an application program under 
NCCE. 


| NLDM must be used with one of the following access methods: 
¢ ACF/TCAM Version 2 Release 4 


« ACF/VTAM Version 1 Release 3 with the appropriate PTF 
or ACF/VTAM Version 2 with the appropriate PTF 


| To collect NCP data, NLDM must be used with the network control program 
ACF/NCP Version 2. 
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Storage Requirements 


The following topics describe pie storage requirements for NLDM, ACF/TCAM, 
and ACF/VTAM. 


NLDM Storage Requirements 


The NLDM virtual and disk storage requirements depend on the number and 
kinds of sessions traced and the amount of session data kept for each session _ 
traced. The storage requirements for a sample network with 500 NAUs are 
shown in the following chart. The sample network has about 1000 sessions, of 
which about one-half are LU-LU sessions. Figures shown in the chart are based 
on keeping 10 PIUs and data for the 10 most recent occurrences of a session for 
each session being traced. 


Virtual Disk (3330) 
Storage Storage 


All sessions involving 
the SSCP traced 95 CYL 
2 eeaeions nvaling 

traced 1.6 M 153 CYL 
All sessions traced 210 CYL 


Figure 6. Sample Network Storage Requirements 


ACF/VTAM Storage Requirements 


To run with NLDM, ACF/VTAM requires at least 2 PIU buffers in the fixed 
common storage area (CSA). Each buffer must be at least 2048 bytes. See 
“Access Method PIU Buffers.”’ 


ACF/TCAM Storage Requirements 


To run with NLDM, ACF/TCAM requires additional virtual storage of 3208 
bytes plus storage for 2 PIU buffers. See ““Access Method PIU Buffers.” 


Access Method PIU Buffers 


The size of the access method PIU buffers ranges from 2K to 32K and is specified 
by the user at NLDM initialization. See the NLDM Installation and Operation 
manual for more information. 
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Performance Considerations 


This topic includes charts showing the expected increase in processor utilization 
when NLDM is running in the following processors: the 158 Model 3, the 
3033U, and the 3081. 


The expected increase in processor utilization is based on the transaction rate of 
the processor and the number of major LUs associated with the processor. A 
transaction consists of a request from a user terminal and the corresponding 
response. Major LUs are the LUs responsible for 80% of the total session 
activity associated with a particular processor. 


The following charts show the transaction rates and numbers of major LUs that 
result in 5%, 10%, and 15% increases in processor utilization when NLDM is 
running. The increases shown are based on running NLDM with all sessions 
being traced. 


To determine the expected increase in processor utilization, find the transaction 
rate and the number of major LUs on the appropriate chart. If, for example, out 
of 1000 active LUs associated with a 3033U processor, 500 LUs are responsible 
for 80% of the session activity, the number of major LUs is 500. If the 
transaction rate for that processor is 5 transactions per second, then the expected 
increase in processor utilization with NLDM running is less than 5%. See 
“Processor Utilization in the 3033U” on page 22. 


Processor Utilization in the 158 Model 3 


This chart shows the 5%, 10%, and 15% increases in processor utilization with 


NLDM in the 158 Model 3. 
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Processor Utilization in the 3033U 


This chart shows the 5%, 10%, and 15% increases in processor utilization with 
NLDM in the 3033U. 
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Processor Utilization in the 3081 


This chart shows the 5%, 10%, and 15% increases in processor utilization with 
NLDM in the 3081. | | 
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Initialization Requirement 


Do not use the access method to automatically activate network resources to be 
used in sessions that are to be traced by NLDM. Instead, start the access method 
without automatically activating resources and then use the CLIST capability of 
NCCF to activate the network resources for which session traces are to be 


started. 
Publications 
Other publications that may be helpful when you are planning for NLDM are 
listed in the following topics. 
NLDM Publications 
The following publications provide additional information about NLDM: 
e Network Logical Data Manager Installation and Operation describes how to 
install and use NLDM. 
¢ Network Logical Data Manager Diagnosis describes what to do if you have a 
problem with NLDM. 
| ¢ Network Logical Data Manager Licensed Program Specifications, GC30-9555, 
describes the Specified Operating Environment for NLDM. 
NCCF Publications 


The following publications provide information about the Network 
Communications Control Facility (NCCF) program product: 


e Network Communications Control Facility General Information, GC27-0429 
¢ Network Communications Control Facility Terminal Use, SC27-0432 

e Network Communications Control Facility Installation, SC27-0430 

e Network Communications Control Facility Customization, SC27-0433 

e Network Communications Control Facility Messages, SC27-0431 


| e Network Communications Control Facility Logic, LY38-3010 
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Systems Network Architecture Publications 


The following publications contain information about Systems Network 
Architecture (SNA): 


e Systems Network Architecture Concepts and Products, GC30-3072 
¢ Systems Network Architecture Reference Summary, GA27-3136 


« Systems Network Architecture Format and Protocol Reference Manual: 
Architectural Logic, SC30-3112 - 


Other Publications 


The following publications contain general information about ACF/TCAM, 
ACF/VTAM, and ACF/NCP: 


¢ ACF/TCAM, Version 2 General Information: Introduction, GC30-3057 


¢ ACF/VTAM General Information: Introduction, GC27-0462 (for 
ACF/VTAM Version 1 Release 3) 


e ACF/VTAM Version 2 General Information, GC27-0608 


© ACF/NCP/SSP for the IBM 3705 General Information, GC30-3058 
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Testing Period 


License 


Program Services 


Warranty 


The basic license testing period is one month (30 days for World Trade). There is 
no testing period for the Distributed Systems License Option (DSLO). 


A separate license is required for each machine on which the licensed program 
materials will be used, except as otherwise provided by IBM. For DSLO licenses, 
central service, including the IBM Support Center, will be provided only through 
the customer location designated for the basic license. 


Central Service, including the IBM Support Center, will be available until 
discontinued by IBM upon 12 months’ written notice. 


Local Licensed Program Support will be available until discontinued by IBM upon 
12 months’ written notice. 


Local Licensed Program Support will be provided under the terms and conditions 
of the Agreement for Local Licensed Program Support for IBM Licensed 
Programs at the Monthly Licensed Program Support Charge, Monthly Additional 
Licensed Program Support Charge, or will be provided at the applicable hourly 
rate. 


Local Licensed Program Support will be provided by IBM Field Engineering for 
DPD and by IBM Customer Engineering for E/ME/A and A/FE. 


NLDM is warranted to conform to its Licensed Program Specifications when 
shipped to the customer if properly used in the Specified Operating Environment. 


Licensed Program Specifications may be updated from time to time and such 
updates may constitute a change in specifications. 


Following the discontinuance of all program services, this program will be 
distributed on an "As Is" basis without warranty of any kind, either express or 
implied. 


Availability of Licensed Program 


The estimated availability date from PID (Program Information Department) is 
8/27/82. Estimated availability at EPL (European Program Library) and other 
WT area Program Libraries is one month later. 
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Glossary 


This glossary defines important NLDM abbreviations and 
terms. It includes terms and definitions from the JBM 
Vocabulary for Data Processing, Telecommunications, and Office 
Systems manual, GC20-1699. Definitions from the American 
National Dictionary for Information Processing are identified by 
an asterisk (*). Definitions from draft proposals and working 
papers under development by the International Standards 
Organization, Technical Committee 97, Subcommittee 1 are 
identified by the symbol '(TC97)." 


ACF/NCP. Advanced Communications Function for the 
Network Control Program. 


ACF/TCAM. Advanced Communications Function for the 
Telecommunications Access Method. 


ACF/VTAM. Advanced Communications Function for the 
Virtual Telecommunications Access Method. 


Advanced Communications Function for the Network Control 
Program (ACF/NCP). A program product that provides 
communication controller support for single-domain and 
multiple-domain networks. 


Advanced Communications Function for the Telecommunications 
Access Method (ACF/TCAM). A program product that 
provides single-domain network capability, and optionally, 
multiple-domain capability. ACF/TCAM runs under MVS and 
OS/VS1 and provides message queuing. 


Advanced Communications Function for the Virtual 
Telecommunications Access Method (ACF/VTAM). A program 
product that provides single-domain network capability, and 
optionally, multiple-domain capability. ACF/VTAM runs 
under MVS, OS/VS1, and VSE and supports direct control 
application programs and subsystems such as VM/VCNA, 
VM/VSPC, and VSE/POWER. 


command. A request from a terminal for the performance of an 
operation or the execution of a particular program. 


domain. In SNA, a system services control point (SSCP) and 
the physical units (PUs), logical units (LUs), links, link 
stations, and all the associated resources that the SSCP has the 
ability to control by means of activation requests and 
deactivation requests. 


logical unit (LU). In SNA, a port through which an end user 
accesses the SNA network in order to communicate with 
another end user and through which the end user accesses the 
functions provided by system services control points (SSCPs). 
An LU can support at least two sessions—one with an SSCP and 
one with another LU--and may be capable of supporting many 
sessions with other logical units. 


LU. Logical unit. 


multiple-domain network. In SNA, a network with more than 
one system services control point (SSCP). 


NAU. Network addressable unit. 
NCCF. Network Communications Control Facility. 


NCP. Network control program. 


network. (1) (TC97) An interconnected group of nodes. (2) In 
data processing, a user-application network. See 
user-application network. 


network addressable unit (NAU). In SNA, a logical unit, a_ 
physical unit, or a systems services control point; it is the origin 
or the destination of information transmitted by the path 
control network. 


Network Communications Control Facility (NCCF). An IBM 
program product consisting of a base for command processors 
that can monitor, control, and improve the operation of a 
network. 


network control program (NCP). A program, generated by the 
user from a library of IBM-supplied modules, that controls the 
operation of the communication controller. 


Network Logical Data Manager (NLDM). A program product 
that helps the user at a central control point to identify network 
problems relating to sessions by means of interactive display 
techniques. 


network operator. A person or program responsible for 
controlling the operation of all or part of a network. 


Network Problem Determination Application (NPDA). A 
program product that assists the user in identifying network 
problems from a central control point using interactive display 
techniques. 


Network Terminal Option (NTO). An IBM program product 
that extends the capabilities of the ACF/NCP to support a 
select group of non-SNA devices. 

NLDM. Network Logical Data Manager. 

NPDA. Network Problem Determination Application. 
NTO. Network Terminal Option. 


* operator. A person who operates a machine. See network 
operator. 


page. The portion of a panel that is shown on a display surface 
at one time. 
panel. In computer graphics, a predefined display image that 


defines the locations and characteristics of display fields on a 
display surface. 
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path information unit (PIU). In SNA, a message consisting of a 
transmission header (TH) alone or of a TH followed by a basic 
information unit (BIU) or a BIU segment. 


physical unit (PU). In SNA, the component that manages and 
monitors the resources (such as attached links and adjacent 
link stations) of a node, as requested by an SSCP via an 
SSCP-SSCP session. 


PIL. Path information unit. 


PLU. Primary logical unit. 


primary logical unit (PLU). In SNA, the logical unit (LU) that 
contains the primary half-session for a particular LU-LU 
session. | 


problem determination. The process of identifying the source of 
a problem; for example, a program component, a machine 
failure, telecommunication facilities, user or 
contractor-installed programs or equipment, an environment 
failure such as a power loss, or a user error. 


PU. Physical unit. 


resource. Any facility of the computing system or operating 
system required by a job or task, and including main storage, 
input/output devices, the processing unit, data sets, and 
control or processing programs. — 


secondary logical unit (SLU). In SNA, the logical unit (LU) that 
contains the secondary half-session for a particular LU-LU 
session. 


session. In SNA, a logical connection between two network 
addressable units (NAUs) that can be activated, tailored to 
provide various protocols, and deactivated, as requested. The 
session activation request and response can determine options 
for such things as the rate and concurrency of data exchange, 
the control of contention and error recovery, and the 
characteristics of the data stream. Sessions compete for 
network resources such as the links within the path control 
network. For routing purposes, each session is identified by 
the network or local addresses of the session partners. 


session awareness data. Data relating to sessions that is 
collected by NLDM and that includes the session type, the 
names of session partners, and information about the session 
activation status. It is collected for LU-LU, SSCP-LU, 
SSCP-PU, and SSCP-SSCP sessions and for non-SNA 
terminals not supported by NTO. 


session data. Data relating to sessions that is collected by 


NLDM and that consists of session awareness data and session 
trace data. 
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session partner. In SNA, one of the two network addressable 
units (NAUs) having an active session. 


session trace. In NLDM, the function that collects session trace 
data for sessions involving specified resource types or involving 
a specific resource. 


session trace data. Data relating to sessions that is collected by 
NLDM whenever a session trace is started and that consists of 
session activation parameters, access method PIU data, and 
NCP data. 


single-domain network. In SNA, a network with one system 
services control point (SSCP). 


SLU. Secondary logical unit 
SNA. Systems Network Architecture. 


SSCP. System services control point. 


system services control point (SSCP). In SNA, a focal point 
within an SNA network for managing the configuration, 
coordinating network operator and problem determination 
requests, and providing directory support and other session 
services for end users of the network. Multiple SSCPs, _ 
cooperating as peers, can divide the network into domains of 
control, with each SSCP having a hierarchical control 
relationship to the physical units and logical units within its 
domain. 


Systems Network Architecture (SNA). The description of the 
logical structure, formats, protocols, and operational sequences 
for transmitting information units through and controlling the 
configuration and operation of networks. 


user. Anyone who requires the services of a computing system. 


user-application network. (TC97) A configuration of data 
processing products, such as processors, controllers, and 
terminals, established and operated by users for the purpose of 
data processing or information exchange, which may use 
services offered by communication common carriers or 
telecommunication Administrations. 


VSAM. Virtual storage access method. 


virtual storage access method (VSAM). An access method for 
direct or sequential processing of fixed and variable-length 
records on direct access devices. The records in a VSAM data 
set or file can be organized in logical sequence by a key field 
(key sequence), in the physical sequence in which they are 
written on the data set or file (entry-sequence), or by 
relative-record number. 
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